home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_52 / rtoc.man < prev    next >
Text File  |  1995-01-01  |  5KB  |  119 lines
  1.         rtoc                            RAVEL                             rtoc
  2.  
  3.         NNAAMMEE
  4.  
  5.         rtoc - Ravel to Cakewalk ASCII translator
  6.  
  7.         SSYYNNOOPPSSIISS
  8.  
  9.         rrttoocc [-s scale] [-p poff] <filename>
  10.  
  11.         DDEESSCCRRIIPPTTIIOONN
  12.  
  13.         rrttoocc is a program that translates a subset of the RRaavveell language
  14.         into an ASCII file format that is acceptable to the CAKEWALK(c)
  15.         sequencer system. CAKEWALK is a good and affordable sequencer
  16.         program available from
  17.  
  18.         Twelve Tone Systems
  19.         P.O. Box 226
  20.         Watertown, MA 02272
  21.  
  22.         Like Ravel, it runs on ibm-pc's and compatibles and uses the
  23.         mpu-401.  Rtoc and ctor are utilities that allow translation
  24.         between a subset of Ravel (actions) and "events" in the CAKEWALK
  25.         system. CAKEWALK provides translation utilities called asc2cake
  26.         and cake2asc that translate between CAKEWALK's internal binary
  27.         format and an external CAKEWALK ASCII event notation. There are
  28.         also utilities for translation from CAKEWALK format to other
  29.         formats. As a result Ravel + CAKEWALK can work together as a
  30.         tool system, each taking advantage of it's own strengths.
  31.  
  32.              The input file is read and is sent to the console; i.e.,
  33.         standard output. It may be redirected to a file using a shell
  34.         redirect '>'; e.g.,
  35.  
  36.         dos> rtoc input.ma > output.asc
  37.  
  38.         The resulting ".asc" output file may be translated from CAKEWALK
  39.         ASCII file format to a ".wrk" file using the ASCII translator
  40.         utilities provided with the CAKEWALK sequencer system.
  41.  
  42.              Rtoc will translate only a very strict subset of Ravel
  43.         statements; essentially notes, patch, bend, poff, rest, key,
  44.         tie, and ccont statements. The expected format is along the
  45.         lines of a voicelist
  46.  
  47.         vco
  48.  
  49.                 note C q
  50.                 note D q 100
  51.                 note E q 120
  52.         end
  53.  
  54.         with only action statements. No programmatic constructs
  55.  
  56.  
  57.  
  58.      December 11, 1988                                               page 1
  59.  
  60.         (if-then-else, etc.) are allowed. This is basically the output
  61.         produced by a simulation run in mos. All forms of note
  62.         statements are accepted. The nnootteedd keyword is also accepted.
  63.         Rtoc is basically a slimmed down version of "mc". Rtoc will
  64.         accept note and time constants, but not predefined velocity
  65.         values (e.g., forte). It cannot handle constant expressions.
  66.  
  67.              Rtoc will handle any number of voicelists, translating each
  68.         into a [TRACK] && [STREAM] event set. Rtoc does not recognize
  69.         the old Ravel "." token which used to mean end of voicelist.
  70.         This should be replaced with an "end" token.
  71.  
  72.              Rtoc will recognize but not translate action statements
  73.         with the following keywords: cparam, dxparam, final, metro,
  74.         param, sig.
  75.  
  76.              The [[--ss ssccaallee]] scale switch is used for scaling event
  77.         times. CAKEWALK treats a quarter note as 120 events. Ravel
  78.         treats it as 24 events. As a result the translator will scale up
  79.         (multiply) all events by a factor of 5. The scale switch may be
  80.         used to specify a different scaling factor (non-zero). A scaling
  81.         factor of 1 would preserve the Ravel units, but of course the
  82.         piece would run faster at the same meter.
  83.  
  84.              The [[--pp ppooffff]] switch is optional and will set the pitch
  85.         bend offset to whatever non-zero value is given. The pitch bend
  86.         offset defaults to 64 if not set. The pitch bend range in MIDI
  87.         is a 14 bit unsigned number; in decimal this is 0 to 16383. A
  88.         centered wheel has the value 8192.
  89.  
  90.              Ravel uses a "pseudo-op" called the "poff" or pitch bend
  91.         offset that is multiplied internally against the value used with
  92.         the pitch bend action; e.g.,
  93.  
  94.         bend q 128
  95.  
  96.         is the value for a centered wheel, since 128 * 64 = 8192. Note
  97.         that a pitch offset of 1 will leave the units unscaled.
  98.  
  99.         SSEEEE AALLSSOO
  100.  
  101.         ctor, mc, mos.
  102.  
  103.         BBUUGGSS
  104.  
  105.         Rtoc is a new utility and has not been tested much at this
  106.         point. There are undoubtedly some flaws.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.      December 11, 1988                                               page 2
  118.  
  119.